# 神策分析

神策数据 （Sensors Data），隶属于神策网络科技（北京）有限公司，是一家专业的大数据分析服务公司，大数据分析行业开拓者，为客户提供深度用户行为分析平台、以及专业的咨询服务和行业解决方案，致力于帮助客户实现数据驱动。神策数据立足大数据及用户行为分析的技术与实践前沿，业务现已覆盖以互联网、金融、零售快消、高科技、制造等为代表的十多个主要行业、并可支持企业多个职能部门。公司总部在北京，并在上海、深圳、合肥、武汉等地拥有本地化的服务团队，覆盖东区及南区市场；公司拥有专业的服务团队，为客户提供一对一的客户服务。公司在大数据领域积累的核心关键技术，包括在海量数据采集、存储、清洗、分析挖掘、可视化、智能应用、安全与隐私保护等领域。

神策数据根基平台是面向业务端的数据平台,搭载数据智能引擎,高效积累数据资产,赋能业务应用场景,助力企业构建扎实的数据根基,实现数字化经营。

- 漏斗模型分析功能使用率 推广功能的曝光,统计用户常用操作，为创建便捷入口提供依据。
- 城市灰度发布 方便内测，屏蔽、排除异常，提前演练节假日活动功能。
- 敏感数据加密 避免信息泄漏、
- 代码扫描 程序常量中不应该明文显示密钥、连接字符串等数据。

`注意`：submitTo 方式是网络直接发送数据，测试时候使用，不要在任何线上的服务中使用此 `Consumer`，线上推荐使用 `LoggingConsumer`。

``` javascript

import SensorsAnalytics from 'sa-sdk-node'

var sa = new SensorsAnalytics;
sa.disableReNameOption();
// 初始化 sa 实例后，不需要设置数据发送地址，只需要通过调用如下语句，设置日志文件存放的目录，这里建议使用绝对路径
var customPath = '/Users/user/logs';
sa.initLoggingConsumer(customPath, pm2Mode)
// ...

```

## 设置用户属性

``` javascript
// distinctId 为用户标识，properties 为要设置的用户属性
sa.profileSet(distinctId, properties); 
```

``` javascript
var properties = {
   // 设置用户等级属性（Level）为 VIP
   'UserLv': 'Elite VIP',
   // $is_login_id 属性判断 distinct_id 是否为登录 ID，如果是则设置为 true，否则为 false，默认为 false
   '$is_login_id' : true,
}

sa.profileSet(distinctId, properties);
```

``` javascript
var distinctId = 'ABCDEF123456789';

// 设置用户渠道属性（AdSource）为 "App Store"
sa.profileSetOnce(distinctId, {
  'AdSource': 'App Store',
  // $is_login_id 属性判断 distinct_id 是否为登录 ID，如果是则设置为 true，否则为 false，默认为 false
  '$is_login_id' : true,

});

// 再次设置用户渠道属性（AdSource），设定无效，属性 "AdSource" 的值仍为 "App Store"
sa.profileSetOnce(distinctId, {
  'AdSource': 'Search Engine',
  // $is_login_id 属性判断 distinct_id 是否为登录 ID，如果是则设置为 true，否则为 false，默认为 false
  '$is_login_id' : true,
});
```

## 自定义事件

``` javascript
// distinctId 是用户标识，event 是事件名，properties 是自定义事件属性
sa.track(distinct_id, event, properties)
```

``` javascript
var distinct_id = 'ABCDEF123456'
var properties = {
    // '$time' 属性是系统预置属性，传入 datetime 对象，表示事件发生的时间，如果不填入该属性，则默认使用系统当前时间
    '$time' : datetime.datetime.now(),
    // '$ip' 属性是系统预置属性
    '$ip' : '123.123.123.123',
    // $is_login_id 属性判断 distinct_id 是否为登录 ID，如果是则设置为 true，否则为 false，默认为 false
    '$is_login_id' : true,
    // 商品 ID
    'ProductId' : '123456',
    // 商品类别
    'ProductCatalog' : 'Laptop Computer',
    // 是否加入收藏夹，Boolean 类型的属性
    'IsAddedToFav' : true,
}

// 记录用户浏览商品事件
sa.track(distinct_id, 'ViewProduct', properties)

var properties = {
    // 用户 IP 地址
    '$ip' : '123.123.123.123',
    // $is_login_id 属性判断 distinct_id 是否为登录 ID，如果是则设置为 true，否则为 false，默认为 false
    '$is_login_id' : true,
    // 商品 ID 列表，list<str> 类型的属性
    'ProductIdList' : ['123456', '234567', '345678'],
    // 订单价格
    'OrderPaid' : 12.10,
}

// 记录用户订单付款事件
sa.track(distinct_id, 'PaidOrder', properties)  
```
